IMotion.SetAxisTouchProbe 方法
发生触发事件时,记录轴的位置。
命名空间:IntervalZero.KINGSTAR.Base.Api组合: IntervalZero.KINGSTAR.Base.Api (于 IntervalZero.KINGSTAR.Base.dll) 版本:4.4.0.0
语法
KsCommandStatus<double> SetAxisTouchProbe(
int Index,
McProbeTrigger TriggerInput,
bool WindowOnly,
double firstPosition,
double lastPosition
)
Function SetAxisTouchProbe(
Index As Integer,
TriggerInput As McProbeTrigger,
WindowOnly As Boolean,
firstPosition As Double,
lastPosition As Double
) As KsCommandStatus(Of Double)
参数
Index [in]
型别:int
轴索引。索引以 0 为起始;别名将影响此参数。
TriggerInput [in]
触发讯号来源。触发可由 Index 指定。
WindowOnly [in]
型别:bool
若设定,则只有在视窗内的值可用来触发事件,视窗范围介于 firstPosition 与 lastPosition 之间。
firstPosition [in]
型别:double
触发事件被认定时的起始位置(正向;使用者单位),值包含在视窗中。目前支援 firstPosition 须小于 lastPosition。
lastPosition [in]
型别:double
视窗内的结束位置(使用者单位),值包含在视窗中。
回传值
回传一个方法的状态及一个 double 值。
备注
- 欲使用此方法,必须使用 IApi.EnableTouchProbe 启动位置抓取功能。
- 一个方法实例仅代表一个位置抓取命令。
- 为避免同一个探针与轴上有多个实例,应使用具有唯一识别的
TouchProbeId
探针命令来扩充 McProbeTrigger 元素,可连结至 IApi.AbortCommand。 - SetAxisTouchProbe 完成后,须等待一个周期,位置抓取才会生效。
- 欲了解位置抓取功能的详细资讯,请参见 概念解说 > 位置抓取功能 (Touch Probe)。
- 当模数轴启用时,模数值会套用至 firstPosition 与 lastPosition 参数,以及回传指令状态中的输出值。
范例
N/A
参见